home *** CD-ROM | disk | FTP | other *** search
/ W95 Shareware Collection / W95 Collection - Windows 95 Shareware (LCDCAN).iso / win95 / internet / twsk95b2 / readme.now next >
Text File  |  1995-11-16  |  4KB  |  103 lines
  1. Notes for the Beta Release of Trumpet Winsock for Windows 95
  2. ------------------------------------------------------------
  3.  
  4. Installation
  5. ------------
  6.  
  7. The winsock should run without any drama with a minimum of installation 
  8. changes from the regular win3.x winsock.  If you have the regular winsock 
  9. running, just add/replace the following files in the same directory.
  10.  
  11. The required files:
  12.  
  13. tcpman.exe           - as for win3.x winsock
  14. winsock.dll          - as for win3.x winsock
  15. twsk16.dll           - 16 bit interface layer
  16. wsock32.dll          - 32 bit thunking winsock
  17.  
  18. These *must* be on the program path.
  19.  
  20. Compatibility
  21. -------------
  22.  
  23. All the functions available from the regular Trumpet Winsock are there.
  24.  
  25. However, the GetXbyY routines, and WSAAsyncGetXbyY routines have required 
  26. recoding into win32 and are currently cut down in functionality
  27. & may be less robust.
  28.  
  29. The following win32 winsock applications have been tested with this winsock.
  30.  
  31. Netscape 32     - no apparent problems.
  32. WinQvtNet 32    - no apparent problems.
  33. WS_FTP 32       - no apparent problems.
  34. HotJava         - crashes regularly.  Reason unknown.
  35. WinVN           - no apparent problems.
  36. MS Telnet       - no apparent problems.
  37. MS FTP          - no apparent problems.
  38.  
  39.  
  40. Trouble spots
  41. -------------
  42. Since the winsock is required to manage it's resources with the possibility 
  43. of being preempted, this version of the winsock now contains special locks 
  44. to prevent reentrancy.  This has required the use of the yield() function, 
  45. which may have an impact on some win16 programs.  Only rudimentary testing
  46. of win16 programs has been done in this area.
  47.  
  48. Should an application crash while a winsock lock is being held (for e.g. 
  49. HotJava) the lock may still be left on.  The winsock attempts to detect
  50. this deadlock condition and clears the lock.  However, in the event of 
  51. this happening, the winsock may be left in an unstable state.  All tests 
  52. have shown that the winsock remains stable in such a case, but stability
  53. cannot be guaranteed under those conditions.  The winsock will display a 
  54. message on the tcpman console should this arise.  If the winsock has been
  55. unable to recover from such an error condition, it may remain deadlocked.
  56. To clear such an error, you can try to terminate the Trumpet Winsock TCPMAN 
  57. task using the ctrl-alt-del combination.   A windows restart may however 
  58. still be required occasionally.
  59.  
  60. The GetXbyY routines use a global return result in wsock32.dll.  I'm not 
  61. sure if each win32 process get's a separate instance of the wsock32 
  62. data area.  If not, there may be trouble with sharing the single global 
  63. return result.
  64.  
  65. WS_FTP32 uses a winsock callback function.  While it seems to work 
  66. correctly, I'm not too sure what will happen when the memory compacter 
  67. starts to shift things around in memory.  Watch out when physical 
  68. memory gets low.
  69.  
  70. WSAAsyncGetXbyY routines start a thread which is local to the process 
  71. calling it.  Hopefully that won't be a problem for most apps.
  72. Also, no size checking is done of the buffers passed to it.  Make sure 
  73. the win32 apps do the right thing.
  74.  
  75.  
  76. How it works.
  77. -------------
  78. The tcpman.exe & winsock.dll are much the same as in windows 3.x.
  79. When a win32 application requires the winsock, it loads wsock32.dll which 
  80. will in turn loads twsk16.dll.
  81.  
  82. Most functions are passed directly to the winsock.  The exceptions are
  83. the getXbyY routines, and the WSAAsyncGetXbyY routines.
  84.  
  85. Bug reports
  86. -----------
  87.  
  88. Send to winsock-support@trumpet.com.au
  89.  
  90. Enjoy!!!  
  91.  
  92. Peter T.
  93.  
  94. Patch List
  95. ----------
  96. Beta 1
  97.     Initial Release
  98. Beta 2
  99.     Fixed GPF caused by WSAUnhookBlockingHook
  100.     Tried to optimize blocking sockets...  blocking sockets hogging CPU
  101.     Added an dummy entry for s_perror (Allows MS FTP.EXE to run)
  102.  
  103.